Delivering Registration Token to the Agent

To deliver a registration token to an agent, first copy the registration token. Navigate to Settings > Device Registration > click token name to display the details. Copy the token from the details. Then, use one of the following methods to add it to the installer:

  1. Installer UI Prompt : Use this method when the Installer is launched manually. During installation, copy the token from the application and paste it when prompted by the Windows or macOS installer.
  2. Silent Install Command : Use this method within a .bat file or script. You can install and register the agent in a single step by running a command. You must copy the installation command from the code block in the application.
    • For Windows: Open an administrator Command Prompt or PowerShell window, paste the installation command, and run it.
      for example,
      msiexec.exe /qn /i kacecloud-VERSION.msi TOKEN="YOUR-TOKEN-VALUE"
      where YOUR-TOKEN-VALUE is the token value.
    • For macOS: Open the Terminal, paste the installation command, and run it.
      for example,
      echo "YOUR-TOKEN-VALUE" > /tmp/ktoken.dat
      sudo installer -pkg "kacecloud-VERSION.pkg" -target /
      rm -f /tmp/ktoken.dat
      where YOUR-TOKEN-VALUE is the token value.
  3. Post-Install Registration Command: Use this method when the agent is already installed on a device, but no token was entered. For example, a device built from an image or template.
    You need to register the device by running a command copied from the code block in the application.
    • For Windows: Open an administrator Command Prompt or PowerShell window, paste the command, and run it.
      for example,
      cd "C:\Program Files\Quest\KACECloud" .\kacecloud.exe --register --payload="YOUR-TOKEN-VALUE"
      net stop kacecloud
      net start kacecloud
      where YOUR-TOKEN-VALUE is the token value.
    • For macOS: Open the Terminal, paste the command, and run it.
      for example,
      cd '/Library/Application Support/Quest/KACECloud/bin'
      sudo ./kacecloud --register --payload='YOUR-TOKEN-VALUE'
      sudo launchctl stop com.quest.kace.kacecloud
      sudo launchctl start com.quest.kace.kacecloud
      where YOUR-TOKEN-VALUE is the token value.

These methods ensure that the agent is registered and able to communicate with the application.